Deprecate gdk_visual_get_bits_per_rgb

This function is pretty useless, since the Wayland backend returns
0 for this, and the Windows backend 42 (!).

diff --git a/gdk/gdkvisual.c b/gdk/gdkvisual.c
index 356ea19295b5c47d1be7ad521339dae701106365..e3c5b6f9c1a24d8e6b7f2a19660ab628f63792b9 100644 (file)
--- a/gdk/gdkvisual.c
+++ b/gdk/gdkvisual.c
@@ -338,10 +338,13 @@ gdk_visual_get_colormap_size (GdkVisual *visual)
  * @visual: a #GdkVisual
  *
  * Returns the number of significant bits per red, green and blue value.
+ * Not all GDK backend provide a meaningful value for this function.
  *
  * Returns: The number of significant bits per color value for @visual.
  *
  * Since: 2.22
+ *
+ * Deprecated: 3.22. Use gdk_visual_get_red_pixel_details() and its variants
  */
 gint
 gdk_visual_get_bits_per_rgb (GdkVisual *visual)

diff --git a/gdk/gdkvisual.h b/gdk/gdkvisual.h
index 3d0f76e527f8b4205d46084164c5361a581264e4..3f603a3989d6ea32493814c28c9a3289cc05d8a2 100644 (file)
--- a/gdk/gdkvisual.h
+++ b/gdk/gdkvisual.h
@@ -119,7 +119,7 @@ GDK_AVAILABLE_IN_ALL
 GdkByteOrder  gdk_visual_get_byte_order          (GdkVisual *visual);
 GDK_AVAILABLE_IN_ALL
 gint          gdk_visual_get_colormap_size       (GdkVisual *visual);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_22
 gint          gdk_visual_get_bits_per_rgb        (GdkVisual *visual);
 GDK_AVAILABLE_IN_ALL
 void          gdk_visual_get_red_pixel_details   (GdkVisual *visual,